home *** CD-ROM | disk | FTP | other *** search
/ Just Call Me Internet / Just Call Me Internet.iso / com / internet / stik / newsie82 / newsie.doc < prev    next >
Text File  |  1997-09-08  |  45KB  |  908 lines
  1. NEWSie - a UseNet Newsreader                          Sept 08, 1997
  2.  
  3. NEWSie uses the NNTP Internet protocol to read UseNet News articles.  It 
  4. provides a standard GEM interface complete with menu, windows, and mouse 
  5. selection.   
  6.  
  7. It uses STiK as the Internet access manager via SLIP connection.  NEWSie 
  8. provides the ability to read, save, and print NEWS articles, and full 
  9. Posting and Reply capabilities.  
  10.  
  11. Articles can be downloaded and read offline.  Offline Posting and 
  12. Followup functions are available.
  13.  
  14. Newsie supports a full complement of e-mail services, including Send, 
  15. Reply, and Forwarding of mail messages.  Multiple mailboxes are 
  16. supported, with transfer of mail between mailboxes.  Mailboxes may be 
  17. sorted in subject, author and date order.  A facility to use and 
  18. edit nicknames is available.
  19.  
  20. NEWSie also provides FTP (File Transfer Protocol) support for the
  21. Atari computer User.  Selection of servers with individual logon id, 
  22. password and directory are provided.  Directory lists are cached to 
  23. provide the fastest access, and directories are automatically retrieved 
  24. when changes have been made.
  25.  
  26. NEWSie will be made available free of charge for download from several 
  27. ftp sites.
  28.  
  29. For more information:
  30. John Rojewski
  31. e-mail:    rojewski@primenet.com
  32. WWW:    http://www.primenet.com/~rojewski/newsie.html
  33.  
  34.  
  35. OVERVIEW
  36.  
  37. This is an attempt to document the facilities of NEWSie, a UseNet 
  38. Newsreader client for the Atari series of computers.  NEWSie is a GEM 
  39. compliant program with standard GUI features including menus, windows, 
  40. dialogs, and mouse and keyboard input.  In addition to UseNet, NEWSie 
  41. supports e-mail send via smtp and receive via pop3 protocols.
  42.  
  43. The following major topics are included in this document:
  44. 1. MENUS
  45. 2. WINDOWS
  46. 3. DIALOGS
  47. 4. FILES
  48. 5. STARTUP OPTIONS
  49. 6. SETUP and USAGE
  50. 7. FUTURE ENHANCEMENTS
  51. 8. KNOWN PROBLEMS
  52.     
  53.     
  54. 1. MENUS
  55.  
  56. File
  57.   The File Menu provides methods to control NewsGroup lists, Article 
  58.   Printing, and Exiting the program.  The Close item provides the ability 
  59.   to close any open window.  The Save As item provides the ability to save 
  60.   the Newsgroup List, current news article, or current mail messages with 
  61.   a different name.
  62.  
  63. Edit
  64.   The Edit Menu contains all the standard Cut, Copy, and Paste commands.  
  65.   Cut, Copy, and Paste are implemented for some windows in this version 
  66.   of NEWSie.  Copy works for the Subscribed Newsgroups, New Newsgroups, 
  67.   and Full Newsgroups windows.  Cut and Paste work only for the Subscribed 
  68.   Newsgroups window.
  69.  
  70. News
  71.   The News Menu contains methods to select Next Article, Next Thread, 
  72.   and Next Group.  Additional items provide the ability to Post messages, 
  73.   and Followup to messages read. The 'Read for Offline' item will
  74.   read all outstanding messages for all newsgroups in the current .GRP 
  75.   file.  (See Offline NewsReading below)
  76.  
  77. Mail
  78.   Mail support is available via the items in this menu.  E-mail send, 
  79.   reply, and forward are available.  The ability to check your POP3 maildrop
  80.   exists, via the Check Mail item, and the Get Mail item will retrieve your 
  81.   mail to your system.   
  82.   An Open In Box item will open and display a list of any messages received.  
  83.   An Open Mailbox item provides the ability to view other mailboxs, including 
  84.   an OUTBOX, which contains a copy of all email which has been sent via NEWSie. 
  85.   There are also user-defined mailboxes that will store inbound 
  86.   mail, and copies of messages sent.  The Edit Nicknames menu allows 
  87.   special receipients to have short nicknames, that are expanded when the 
  88.   message is actually sent.
  89.   The Address book may be opened, and Address may be added while viewing 
  90.   either news or mail messages by selecting the 'Add to Address Book' 
  91.   item.
  92.   A 'Send Queued Mail' item has been added to this menu. 
  93.   
  94. FTP
  95.   The FTP menu provides the ability to get and put files on FTP servers.  
  96.   The menu is split into two (2) sections.  The first for Servers: 
  97.   selecting, editing, adding and deleting.  The second is for moving 
  98.   through the server directories and retrieving, storing, or deleting files.
  99.   
  100. Special
  101.   The Special Menu contains some additional items, including the retrieval 
  102.   of the Full Group list, and any new Newsgroups. Manual Connect and 
  103.   Disconnect are avaialble.  A final item (Open URL) allows you to 
  104.   retreive any Web reference (http-web page, graphic, etc.) from within 
  105.   NEWSie.  The ability to extract UUEncoded articles is provided.  The Log 
  106.   file can be viewed online via the 'Show Log File' menu item.
  107.  
  108. Preferences
  109.   The Preferences Menu supplies a variety of areas that the user needs to 
  110.   change to configure NEWSie to work with his/her Internet Service Provider 
  111.   (ISP) and also to allow the user to define some defaults for system 
  112.   operation.  Most selections present a Dialog to the user.
  113.  
  114.  
  115. 2. WINDOWS
  116.  
  117. Subscribed NewsGroups
  118.   The Subscribed NewsGroups window displays the NewsGroups that you have 
  119.   selected to be kept aware of new articles.  A NewsGroup is a category of 
  120.   messages that (should) relate to some topic.
  121.   There are many thousands of NewsGroups, and not all News Servers (ISPs) 
  122.   offer all NewsGroups.  You may manually enter the name of a NewsGroup you 
  123.   are interested in viewing, or in combination with the Full NewsGroup 
  124.   and New NewsGroup windows, Subscribe to additional NewsGroups.
  125.   If your ISP does not support a particular newsgroup in the Subscribed 
  126.   Newsgroups list, it will be marked with a '?' in the first column of the
  127.   display.   You may select such a group, but the only action that may be
  128.   performed is to UnSubscribe.
  129.  
  130. Article Overview
  131.   For any given NewsGroup, selecting that NewsGroup via a double-click or 
  132.   Return Key in the Subscribed NewsGroup window will fetch the Article 
  133.   Overview list from the News Server.  This list is displayed in the 
  134.   Article Overview window.  The overviews are formatted with: 
  135.      Article number
  136.      Subject
  137.      Author
  138.      Date of submission
  139.      Number of lines of message text
  140.   Any of the overviews can be selected via mouse click or keyboard up and
  141.   down arrow keys.  When selected, the article overview is displayed in 
  142.   color RED (subject to preferences).  For Monochrome users (ST-High), the
  143.   selected article will be underlined. 
  144.   Shift up/down arrows will scroll a page.
  145.   
  146.   A double-click or Return key will fetch the selected Article from the 
  147.   News Server.
  148.   
  149.   Article Threads are recognized.  Threads are a group of related articles,
  150.   and are marked with a '+' for the primary article, and '-' for subordinate
  151.   articles.  Threads formatting is dependent upon the Newsreading Preferences
  152.   'Create Threads' and 'Collapse Threads'.  If 'Create Threads' is un-selected,
  153.   then Thread processing is bypassed and articles are shown in numeric
  154.   (ascending) order.  If 'Create Threads' alone is selected, both the primary
  155.   ('+') articles and subordinate ('-') articles will be displayed.  If the 
  156.   'Collapse Threads' option is selected, only the primary ('+') articles  
  157.   will be displayed.
  158.   The left and right arrow keys control the expansion and/or collapse of
  159.   individual threads.  Selecting a primary article and pressing the right 
  160.   arrow key will display all subordinate articles for that thread.  Clicking
  161.   the left arrow on the primary, or any subordinate article, will collapse
  162.   the thread back to just the primary article.
  163.  
  164. Article Text
  165.   The Article Text window displays a News Article.  The article contains a 
  166.   header and the message body.  The header contains lines such as: Author, 
  167.   Subject, Date, etc.  The body contains the message response entered by 
  168.   the author.  Each article read is available on your local disk as 
  169.   'NNNNNN.TXT', where NNNNN is the Article number.  These files can be 
  170.   deleted by you as you choose by pressing the Del key within the window.
  171.   This provides a method to keep un-wanted messages from accumulating.
  172.  
  173.   Up/down arrows will scroll 1 line, and Shift up/down arrows will 
  174.   scroll a page.
  175.   
  176.   If you prefer an external viewer program instead of the builtin window, 
  177.   you may select a viewer program from the Preferences menu in the Path
  178.   Preferences dialog (External Viewer Path).  Once this is done, selecting
  179.   'Use External Viewer' in the Newsreading Options dialog will cause NEWSie
  180.   to call the external program with the article filename.
  181.   
  182.  
  183. Offline Newsreading
  184.   NEWSie supports offline newsreading with version 0.60.  The menu item
  185.   'Read for Offline' will read all outstanding articles in all newsgroups 
  186.   in the current Subscribed Newsgroups window.  Warning:  until you are 
  187.   familiar with the operation of this program, the author suggests you 
  188.   limit the number of newsgroups/articles to some finite number less than 
  189.   ten newsgroups and a total of 100 articles.   A maximum of 400 articles 
  190.   can be maintained for each newsgroup (if you have the disk space!).
  191.  
  192.   The 'Read for Offline' menu item is used while online (connected to your 
  193.   mail server) and will build a set of files and directories in the 
  194.   directory you have named as the 'Offline Path' (see Path Preferences).
  195.   The Escape key is active, and will abort this function at any time.
  196.  
  197.   After reading the articles, Quit NEWSie, Disconnect STiK, and start 
  198.   NEWSie again.  This time, you will be able to view the articles saved on 
  199.   disk in the same way as online articles.  The delete key will delete 
  200.   articles on disk, and also remove the entry in the Overview window when 
  201.   the window is closed.
  202.   
  203.   Offline Posting of new articles, and Followups to articles read is now 
  204.   supported.  These articles are created as the result of a Post/Followup 
  205.   followed by a 'Send' or 'Queue' when there is no connection to the News 
  206.   Server.  At the next time there is a connection to the News Server, 
  207.   these articles are transmitted, and deleted from your system.
  208.    
  209.   To view the articles waiting to be Posted, use the 'Open Offline 
  210.   PostBox' item in the News menu.  This will open the PostBox (if it 
  211.   exists) and allow you to view/edit the articles, and/or delete them 
  212.   before they are sent via the 'Delete' key.
  213.   
  214.   There are (currently) no preference controls on this function. 
  215.  
  216.    
  217. New NewsGroups
  218.   The New NewsGroups window displays a list of NewsGroups created after a 
  219.   certain Date and Time.  The data and time are entered by the user in a 
  220.   dialog.  This list can be referenced and any of the NewsGroup names 
  221.   can be selected, and Subscribed to.  When the Subscribe is performed, the 
  222.   NewsGroup name is added to the Subscribed NewsGroup window, and is 
  223.   immediately available for use.  A double-click with the left mouse button,
  224.   or selecting Subscribe from the Special menu performs the Suscribe function.
  225.  
  226.   If you have enough memory, a sort will take place.  This will also 
  227.   remove extraneous information from the NEWGRP.TXT file (thus reducing 
  228.   its size) and will create a NEWGRP.IDX file which is used to reduce the 
  229.   time required to scroll through the file.
  230.  
  231.   Shift up/down arrows will scroll a page.
  232.      
  233.   Search and Match are available via the 's' and 'm' keys respectively.
  234.   
  235.   
  236. Full NewsGroups
  237.   The Full NewsGroups window serves a similar purpose, but contains a 
  238.   complete list of all NewsGroups available from your News Server.  Because 
  239.   this file can be very large, it may take several minutes to fetch it. 
  240.   The same selection and subscription ability exists for this window as for 
  241.   the New NewsGroups window.  An attempt to sort this file will be made.  
  242.   If you have enough memory, the sort will take place.  This will also 
  243.   remove extraneous information from the FULLGRP.TXT file (thus reducing 
  244.   its size) and will create a FULLGRP.IDX file which is used to reduce the 
  245.   time required to scroll through the file.
  246.  
  247.   Shift up/down arrows will scroll a page.   
  248.     
  249.   Search and Match are available via the 's' and 'm' keys respectively.
  250.   
  251.  
  252. MailBox
  253.   The Mailbox window displays the contents of various mailboxes.  Two 
  254.   Mailboxes are provided by NEWSie, the InBox and the OutBox.  The InBox 
  255.   contains a list of all emails received via the Get Mail Menu title.  
  256.   After receiving mail, clicking on the Open In Box will display the 
  257.   messages with a 'U' (unread) in the first column.  Double-clicking on 
  258.   any message line will open the Mail Text window (see below).  Arrow keys 
  259.   will move up or down in the list, and the return key will also select 
  260.   the current mail message.  The delete key will mark the item for 
  261.   deletion when the window is closed.
  262.  
  263.   A 'transfer' from any mailbox to any other mailbox (including creating a 
  264.   new mailbox) by pressing the 't' key.  To create a new MailBox, enter 
  265.   the Mailbox name followed by '.MBX' in the file selector (i.e. NEW.MBX).
  266.   (Of course the name can be anything, but NEWSie will only look for MBX 
  267.   files by default.)
  268.   
  269.   You may sort the mailbox in any or three ways.  By author ('a'), subject 
  270.   ('s'), or date ('d').  (Some date stamps are non-standard, and may 
  271.   produce undesirable sort order.)
  272.   
  273.   Shift up/down arrows will scroll a page.
  274.    
  275.   Holding down the Shift key and pressing return will open the External
  276.   Editor with the selected Mail Message.
  277.  
  278.   
  279. Mail Text
  280.   This window displays the content of any of the selected Mailboxes.  This 
  281.   window is shown unless the 'Use External Viewer' option is selected.
  282.     
  283.   The delete key serves the same function as in the MailBox window, 
  284.   namely, to delete the current mail message when the MailBox window is 
  285.   closed.
  286.   
  287.   Up/down arrows will scroll 1 line, and Shift up/down will scroll a page.   
  288.  
  289.  
  290. FTP
  291.   Three windows are provided for FTP support.  The Server window allows the 
  292.   user to open a connection with an existing server, add a new server, 
  293.   edit an existing server parameters, or delete a server.  The return key 
  294.   is used as a shortcut for Open, Insert for new, '?' for edit, and Delete 
  295.   for delete.
  296.   
  297.   The Directory window is visible after an FTP session has been 
  298.   established.  The window contains a file attributes list, the file or 
  299.   directory name, the size of the file, and date and time the file was 
  300.   last updated.  Keyboard shortcuts are available.  Return will retrieve a 
  301.   file, or open the directory (if the entry is a directory).  Delete will 
  302.   delete the file (or directory), Insert will prompt for a file to upload 
  303.   (i.e. store) on the server, and Shift-Insert will allow the user to 
  304.   upload a file with a different name.  The ability to create a new 
  305.   directory is available from the FTP menu or via the 'm' key.  Default 
  306.   transfer mode is Binary, however the 'a' key will use Ascii mode for the 
  307.   next transfer, and 'b' will use binary mode.  Any directory retrieval 
  308.   will revert back to binary mode.
  309.  
  310.   The third window is the 'view' uption.  This provides the ability to
  311.   download a file and display it immediately on the screen within a
  312.   window.  This is designed for text files only, to read INDEX files and
  313.   other documentation related things.
  314.  
  315.    
  316. Help
  317.   Window related help is available via the HELP key, or right mouse button 
  318.   click.  In machines with AES 3.3 or higher, there are window specific 
  319.   popup command menus which include a Help entry.  These popup menus can 
  320.   make operating NEWSie more efficient and pleasant.
  321.   
  322.   If you have ST-Guide installed in your computer, NEWSie provides .HYP 
  323.   format help files instead of the test files.
  324.   
  325.   
  326. Log
  327.   The Log window is provided to allow the user to see the results of 
  328.   various activities online.  This is particularly useful to see the 
  329.   preamble text from some anonymouse FTP sites, and possible error 
  330.   conditions.  The Log Window can be opened via the 'Show Log File' menu 
  331.   item in the Special menu.  Scrolling up and down is provided.  
  332.   Additionally, any keypress or mouse click within the window will update 
  333.   the window display to allow viewing of the entire log file, since it may 
  334.   have increased in size since the window was opened. 
  335.    
  336. Address Book
  337.   The Address Book window is very similar in function to the FTP Server 
  338.   window in many aspects.  The ability to Add, Edit or Delete entries in 
  339.   the Address Book are primary functions.  While sorting of the entries is 
  340.   automatic for insertions, editing the name will not automatically 
  341.   re-sort the Address Book and a manual Sort function is provided.  
  342.   Selection of an address is via mouse click or arrow keys.  The current 
  343.   email address will be shown in red (underlined for Monochrome).  
  344.   Pressing the return key or double-clicking will open a Send Mail dialog 
  345.   with the selected user name and address inserted, ready for the Subject 
  346.   to be inserted.  An Info area is provided in the Edit dialog to insert 
  347.   some comment or note about the user.  The Address book file is limited 
  348.   to about 32,700 entries, but may be smaller if less memory is available 
  349.   on your machine.
  350.  
  351. Browser Window
  352.   Starting with version 0.80, the browser window will be opened when any text 
  353.   file is selected via the 'Open URL' menu item.  In this initial offering, only
  354.   the raw text is displayed, and no formatting is performed.  As additional time
  355.   becomes available, HTML formatting will be performed.  Standard scrolling is
  356.   handled for this window.
  357.    
  358.  
  359. 3. DIALOGS
  360.  
  361. Personal Preferences
  362.   The Personal Preferences dialog provides the ability to enter information 
  363.   about the user.  Fields include:
  364.      Full Name
  365.      Organization name
  366.      E-mail address
  367.      Account name - contains your ISP account name for mail.
  368.  
  369. Server Preferences
  370.   The Server Preferences dialog provides the ability of the user to specify 
  371.   information about the Internet servers that will be used to access the 
  372.   News and Mail systems.  Fields include:
  373.      NewsServer name
  374.      MailServer names (both SMTP (send) and POP3 (receive))
  375.      Connect to NewsServer on startup indicator
  376.      Open Subscribed Newsgroups window on startup indicator
  377.      2 TCP/IP timeout values
  378.  
  379. General Preferences
  380.   A long time in arriving, this dialog is for additional things
  381.   that work across all protocols, windows, etc.  Initially this includes:
  382.     Auto-Topping Windows - selecting this option will cause the window the
  383.       mouse is over to become the top window, without any clicking.  The
  384.       status window is excluded from this contol, that is, if the status
  385.       window is top, the auto-topping is ignored.  The delay for recognizing
  386.       a new top window is 0.5 seconds.  Leave this option off (un-crossed)
  387.       to maintain the old method of selecting a window.
  388.     Toolbars - an added feature in NEWSie 0.78.  Certain windows can 
  389.       have a toolbar (ie. button bar) placed wither at the top or bottom of 
  390.       the window.  These buttons provide a fast efficient way to perform 
  391.       common functions.  Toolbars are unique to the specific window.  
  392.       Selecting just the Toolbars defaults to a position at the top of the 
  393.       window, and selecting the 'at bottom' box with display at the bottom 
  394.       of the window.
  395.   Look for other options to be put into General Preferences.
  396.  
  397. News Reading Preferences
  398.   The News Reading Preferences dialog provides the user with several 
  399.   options pertaining to the method by which NEWSie will display News 
  400.   Articles on the user's screen.  Fields include:
  401.      Display the article header lines
  402.      Maximum number of messages to read
  403.      Use External Viewer
  404.      Create Threads
  405.      Collapse Threads
  406.      Most recent 'n' articles
  407.      Allow Offline Newsreading
  408.      Erase articles after viewing
  409.      
  410. Mail Preferences
  411.   The Mail Preferences include several features for storing and 
  412.   manipulating e-mail.  fields include:
  413.      Delete Mail from Server after Receipt
  414.      Use a saved password
  415.      The user's password (saved in the Prefs file)
  416.      Send Queued Output at Check_Mail
  417.      Delete Queued Output after being sent
  418.      
  419. Message Preferences
  420.   The Message Preferences dialog provides the user with several options 
  421.   pertaining  to the method for responding to Articles read.  These include:
  422.      Followup to NewsGroup
  423.      Reply to the article's author via e-mail
  424.      Send copy to yourself via e-mail
  425.      Character(s) to indicate a quote
  426.  
  427. FTP Preferences Dialog
  428.   This dialog is used to set various FTP preferences. These include:
  429.     Send HELP at connect - a list of valid commands are written to
  430.       the log file if allowed in the Log Preferences
  431.     Issue Allocate before Store - send command to allocate storage
  432.       space on server.  Some servers ignore this command, and some need it.
  433.     Save Last Directory - saves name of the latest directory referenced on
  434.       a server if selected.  This was the default in prior versions of NEWSie.
  435.       Saving this directory name means that connecting to the server will
  436.       automatically take you to the same directory you last referenced.
  437.  
  438. Path Preferences
  439.   The Path Preferences dialog allows the user to specify where additional 
  440.   files, articles, etc. should be stored in the user's computer file system.
  441.   These include:
  442.      Work Path
  443.      Mail Path (for e-mail)
  444.      Offline Path (for offline newsreading)
  445.      External Editor Program
  446.      External Viewer Program
  447.   Note: The Titles are also selectable, and they allow the same 
  448.   functionality as selecting the Path objects they represent.
  449.  
  450. Log Preferences
  451.   The Log Preferences dialog allows the user to specify how much or how 
  452.   little information is recorded about the actual activity of NEWSie in 
  453.   retrieving and replying to articles.  In general, there is little 
  454.   information in the Log for casual users, and most users will not need to 
  455.   change these preferences.  The 'Log Data' selection is unused (i.e. it 
  456.   does nothing.  'Mask Passwords' will change any password characters into
  457.   a string of '*'s, before logging to prevent accidently exposing your
  458.   passwords.
  459.   The option 'Log Transfer Rates' will provide a character per second (cps) 
  460.   calculation for files being received.  No calculation is provided for 
  461.   files being sent to the server.
  462.  
  463.  
  464. Signature Preferences
  465.   The Signature Preferences dialog is provided to allow users to suffix any 
  466.   reply or posted responses with their selected signature.  The filepath
  467.   displayed indicates the current signature file, and the first several lines
  468.   of text are displayed.  Clicking on the filename allows the user to select 
  469.   a new signature file.  As with the Path Preferences dialog above, the 
  470.   Signature Path title is also selectable, and provides the same 
  471.   functionality as selecting the filename object.
  472.  
  473. Font Preferences
  474.   The Font Preferences dialog is provided to allow the user to vary the font
  475.   displayed in the NewsGroup, Overview, and Article windows.  For those users
  476.   the have some version of GDOS (including NVDI), they may select any of several
  477.   font faces and point sizes.  Clicking on the arrow box on the right of the
  478.   font name will 'drop down' a font selection list.  Arrow buttons in the list
  479.   allow for scrolling.  Clicking on any font name will select that font for use.
  480.  
  481.   In the event that the chosen font does not exist in a particular configuration,
  482.   the default system font will be used instead.
  483.   
  484. Transfer Status
  485.   The Transfer Status dialog is an output only dialog provided to give the 
  486.   user visual feedback of data transfers as they occur.  This is status is 
  487.   available whenever there is information being received from the servers, 
  488.   or being sent to the servers.  The Transfer Status display may be disabled
  489.   by un-selecting the 'Show Status' option in the Newsreading Preferences 
  490.   dialog.  This can be classified as a window too, since it is now
  491.   non-blocking.
  492.  
  493. Full NewsGroup Warning
  494.   The Full NewsGroup Warning dialog is provided to warn the user that this 
  495.   transfer can take a long time and use a lot of disk space.
  496.  
  497. Full NewsGroup Re-load
  498.   The Full NewsGroup Re-load dialog is provided to allow the user to use 
  499.   the existing Full NewsGroup list or download a new one.  Using the 
  500.   existing file is much faster.
  501.  
  502. New NewsGroup Selection
  503.   The New NewsGroup Selection dialog is provided to allow the user to see 
  504.   any NewsGroups that have been created since a specified date.  This, in 
  505.   combination with the Full NewsGroup list, will allow the user to access 
  506.   new NewsGroups as they become available.
  507.  
  508. Subscribe to NewsGroup
  509.   The Subscribe to Newsgroup dialog is presented in several situations:
  510.      double-click in the Full Newsgroups window
  511.      double-click in the New Newsgroups window
  512.      The Subscribe Menu title
  513.      Insert key in the Subscribed Newsgroups window
  514.   In the first 2 cases, the Newsgroup name will be displayed. Clicking on
  515.   the OK button will enter the Newsgroup into the current Subscribed NewsGroup
  516.   file (i.e DEFAULT.GRP, or other).  The 3rd case (Subscribe Menu) can be used
  517.   instead of the double-click, but may also be used at any time to allow the
  518.   user to type in the name of a Newsgroup.  The 4th case (Insert key) will
  519.   also allow the user to type in a Newsgroup name.  Note that if the 
  520.   Newsgroup name is invalid or unsupported by your ISP, the current Subscribed
  521.   Newsgroup file/window will not be updated.
  522.  
  523. UnSubscribe from Newsgroup
  524.   The UnSubscribe from Newsgroup dialog is presented in the following
  525.   situations:
  526.     The UnSubscribe Menu title
  527.     Delete key in the Subscribed Newsgroups window
  528.     
  529.   In either case, the currently selected Newsgroup is displayed in the
  530.   dialog with question 'UnSubscribe from Newsgroup?'.  Pressing the OK
  531.   button deletes the Newsgroup from the Subscribed window and file.     
  532.  
  533. Edit Nicknames
  534.   The Edit Nicknames dialog is available to allow sending messages to 
  535.   people that you will frequently correspond with, or for implementating 
  536.   mailing list of several people whom you wish to send the same message 
  537.   to.  Clicking on a empty Nickname (left column) will add a new nickname. 
  538.   DO NOT use spaces, as everything past first space will be ignored.  A 
  539.   Description is available to describe the nickname.  To add email 
  540.   addresses to a Nickname, click on the nickname, then click on an empty 
  541.   entry in the Address (right column), and fill in the email address.  
  542.   When completed, click OK to save the additions/changes, or Quit to leave 
  543.   the edit dialog without any changes.  There is a limit of 100 entries, 
  544.   which include Nicknames, Descriptions, and Addresses.  No more than 30 
  545.   nicknames, or 30 addresses per nickname are allowed by the dialog.
  546.  
  547.   With Version 0.82, if you use Magic, or have WDIALOG.PRG in your AUTO 
  548.   folder, this dialog will operate like a window.  It is therefore non-
  549.   blocking and moveable.  The window closer gadget operates like the CANCEL 
  550.   button in the dialog (i.e. no changes saved).
  551.   
  552. Edit Server
  553.   The Edit Server dialog is provided to allow a user to enter a new FTP 
  554.   server name and logon information, or, to edit the information of an 
  555.   existing server.  A sample of servers is provided in the DEFAULT.SVR 
  556.   file.  The logon name can be specific or 'anonymous' for servers which 
  557.   allow anonymous FTP sessions.  The accepted password for an anonymous 
  558.   FTP connection is the user's e-mail address.  A The starting directory is
  559.   saved after a session if selected in the FTP Preferences dialog,
  560.   and can be changed before opening the connection if desired.
  561.   If the logon name is missing, 'anonymous' is used.  The the password is
  562.   missing, the user's email id is used for 'anonymous', or the user is
  563.   prompted via the password dialog if the logon name is something else.
  564.   A maximum of 30 server definitions are supported.
  565.  
  566.   There is now an additional parameter which allows the selection of a 
  567.   port number.  This number may be 0 thru 9999.  The default value is 21.
  568.   This default is used if the port field is empty (null string).
  569.      
  570. Edit Function Keys
  571.   As part of a request to support better keyboard shorcuts this
  572.   feature provides the ability to select any Menu function via one of the
  573.   20 Programmable Function Keys at the top of the keyboard.  The Edit
  574.   Function Keys menu item in the Preferences Menu will display a dialog
  575.   containing the editable text.
  576.  
  577.   The dialog consists of 2 columns of 10 editable fields for the user to
  578.   enter the text of the Menu Function to be executed when that function key
  579.   is pressed.   The compare is case-insensitive, so 'quit' works just as
  580.   well as 'Quit'.  The compare is for the length of the input text, so just
  581.   a 'q' will execute the 'Quit' menu item.
  582.  
  583.   Cancel and OK buttons are provided.  The Cancel button is the default,
  584.   and the OK button saves the changed definitions into a text file.
  585.  
  586. Address Book
  587.   As part of the Address Book, this dialog provides the ability to edit 
  588.   information in the Address Book.  This dialog is used to request user 
  589.   verification of additions to the Address Book and well as edits.  Cancel 
  590.   and OK buttons are provided.  Clicking on the OK button will initiate a 
  591.   save of the Address Book. 
  592.    
  593. STiK Disabled
  594.   The STiK Disabled dialog is displayed at startup when the STiK accessory 
  595.   is not 'enabled'.  STiK must be enabled and most likely connected to the 
  596.   user's Internet Service Provided (ISP) before NEWSie can access new 
  597.   articles.
  598.  
  599. Post/Followup Article
  600.   This dialog allows you to respond to News postings, or create a new News 
  601.   article to the selected Newsgroup.  A Newsgroup name may be entered into 
  602.   the dialog directly, but to eliminate the possibility of typing mistakes, 
  603.   the prefered method is to use the Newsgroup name filled in by NEWSie from 
  604.   the selected newsgroup in the Seubscribed Newsgroups window.  A subject 
  605.   should be entered for New Posts.  NEWSie will automatically generate a 
  606.   'Re:' prefix for Followups.  Use the 'Cancel' button to cancel the Post/
  607.   Followup.  Use the 'Edit' to create your Post or Followup text, and use 
  608.   the 'Send' or 'Queue' to send the Post/Followup immediately, or queue it 
  609.   for later submission.
  610.  
  611. Send/Reply/Forward Mail
  612.   This dialog allows you to send mail, to reply to mail received, and to 
  613.   forward mail to another user.  After selecting a recipient via the To: 
  614.   editable field, and putting something onto the Subject: field, you may 
  615.   select the 'Edit' button to enter the external editor.  The 'cc:' field 
  616.   is also available to send a copy to another person.  After completing 
  617.   the editing, and quitting the editor, this dialog will again appear, and 
  618.   you may choose 'Cancel', 'Send' or 'Queue'.  Choosing 'Send' will send 
  619.   the message immediately if online, or queue the message in the OUTBOX 
  620.   mailbox to be sent at a later time.  'Queue' will just queue the message.
  621.  
  622.   The 'To:' and 'cc:' buttons allow a fast access to Nicknames to fill into 
  623.   the fields.  These buttons will also display up to the first 300 entries 
  624.   in the Nicknames/Address Book.  This provides additional functionallity 
  625.   for addressing email.
  626.  
  627.   A single File Attachment is now supported, with three (3) encoding options: 
  628.   None, UUE, or MIME encoding.  These methods are compatible with the decoding 
  629.   options already provided by NEWSie.  The encoding buttons are radio-buttons, 
  630.   so only one is selectable at a time.  The encoding is performed before the 
  631.   file is presented to the user for editing.  The user should be careful not 
  632.   to change any of the encoded text or associated headers, because this may 
  633.   render the encodings un-decipherable and un-usable by the recipient.  To 
  634.   cancel a file attachment in the dialog, select it again, and press the CANCEL 
  635.   button in the file selector.
  636.  
  637. 4. FILES
  638.  
  639. Resource
  640.   The NEWSIE.RSC file is required for operation.  It should be in the same 
  641.   directory as NEWSIE.PRG.  This file contains all of the Menu and Dialog 
  642.   definitions.  There should be no reason for the user to modify this file 
  643.   in any way.  
  644.   
  645.   There is a French resource NEWSIEFR.RSC.  If you wish to use this 
  646.   resource, rename the original English version (NEWSIE.RSC to 
  647.   NEWSIE.RSX), and rename the NEWSIEFR.RSC to NEWSIE.RSC.  See the 
  648.   LANGUAGE folder for other French translations of NEWSie documentation.  
  649.   Feel free to replace the English HELP files with the French counterparts 
  650.   if you would like. 
  651.  
  652.   There is also an Italian resource NEWSIEIT.RSC.  Italian documentation 
  653.   is included in the LANGUAGE\ITALIAN directory.
  654.   
  655.   There is also a Swedish resource NEWSIESV.RSC.  Swedish documentation 
  656.   is included in the LANGUAGE\SWEDISH directory.
  657.   
  658. Support Program(s)
  659.   With NEWSie 0.54, the UUD.TTP program is provided.  It should be placed in
  660.   the directory configured as the Work Path.  This program provides the 
  661.   service of decoding any UUEncoded data in retrieved messages.  This encoded 
  662.   data is most generally a binary file (picture or program).  The 'Extract 
  663.   Binaries' menu item in the Special Menu uses this program.
  664.   
  665.   With version 0.74, the MUNPACK.TTP program is provided.  It should also 
  666.   be placed in the Work Path directory.  This program provides the service 
  667.   of decoding MIME uncoded data (base64, etc.).  The 'Extract Binaries' 
  668.   menu will examine the current file and select this module if the article 
  669.   or messages contains MIME control statements.  Many thanks to programmer 
  670.   Jos den Bekker for writing this fine program.
  671.  
  672. Preferences
  673.   The PREFS.INF file is required for proper operation. It should be in the 
  674.   same directory as NEWSIE.PRG.  There is a generic PREFS.INF file in the 
  675.   distribution.  Feel free to use this as the basis for configuring NEWSie 
  676.   to your preferences.  See the individual Preference dialogs for any 
  677.   specific options available.
  678.  
  679.   Note that NEWSie will automatically update your existing PREFS.INF file 
  680.   to include all of the most recent parameters when you execute a more 
  681.   current version of NEWSie.
  682.  
  683. Subscribed NewsGroups
  684.   The DEFAULT.GRP file is required for proper operation.  There is a 
  685.   generic DEFAULT.GRP file in the distribution.  You may add new NewsGroups 
  686.   to this, and delete ones you are not interested in subscribing to.  You 
  687.   may have several Subscribed NewsGroup files, and use them interchangeably.
  688.   The DEFAULT.GRP will be used by NEWSie at startup.  A GRP file can 
  689.   contain a maximum of 100 newsgroup names.
  690.  
  691. Full NewsGroups
  692.   The FULLGRP.TXT file is an optional file.  It is optional because it can 
  693.   be extremely large, possibly larger than 1 Meg.  This file is retrieved 
  694.   from your selected News Server only if you request it.  Once retrieved, 
  695.   it is used until you request it again.  This file will contain a listing 
  696.   of all the NewsGroups that are available for subscription from your News 
  697.   Server.  An FULLGRP.IDX file is created when the file is sorted.
  698.  
  699. MailBoxes and Mail
  700.   A MAIL path is available in the Path Preferences.  Within this path 
  701.   NEWSie will establish MailBoxes and Mail messages.  MailBoxes are 
  702.   expected to have a suffix of .MBX, and Mail messages will be in the form 
  703.   MAILnnnn.TXT, where nnnn is a unique number from 0000-9999.
  704.   A mailbox can contain a maximum of 100 messages.  There is no limit to 
  705.   the number of mailboxes, except local disk storage.
  706.   
  707. Log
  708.   The LOG file is a temporary file created by NEWSie during its processing. 
  709.   It is of most interest to the author and to others who want more 
  710.   information about the workings of NEWSie and other UseNet news reader 
  711.   programs and the associated commands, protocol, etc.  The Log Preferences 
  712.   dialog will allow you to configure the information put into this file as 
  713.   you choose.  The Log file is viewable via the 'Show Log File' menu entry 
  714.   in the Special menu.
  715.  
  716. Offline Articles
  717.   If you choose to use the Offline Newsreading features, you should 
  718.   specify a Offline Path directory (OFFLINE is included in the 
  719.   distribution file).  NEWSie will create a set of directories under the 
  720.   selected Offline path for each newsgroup that can have offline articles.
  721.   The names of these directories are a 'compression' of the newsgroup 
  722.   name.  The articles are placed in the respective directory in the same 
  723.   format as for online articles ('NNNNNN'.TXT') in separate files.
  724.  
  725. Offline Posts and Followups
  726.   Articles are saved in files named 'POSTNNNN.TXT' in the WorkPath.
  727.   An index of these files is called 'POSTS.PBX' (PBX being similar  
  728.   to MBX, meaning PostBoX).  These files are created as the result of a 
  729.   Post/Followup followed by a 'Send' or 'Queue' when there is no connection 
  730.   to the News Server.  At the next time there is a connection to the News 
  731.   Server, these files are transmitted, and deleted from your WorkPath.
  732.  
  733.   If before you connect to the News Server, you decide to refrain from 
  734.   Posting something, you should use the 'Open Offline PostBox' menu item 
  735.   in the News menu to review and/or delete the offending file(s) via the 
  736.   'Delete' key.
  737.  
  738. Nickname
  739.   The NICKNAME.TXT file is used to store nicknames and addresses.  In 
  740.   future versions, there may be several selectable filenames, and size 
  741.   limitations may be changed. 
  742.    
  743. FTP Servers
  744.   The DEFAULT.SVR file contains several FTP server names, with anonymous 
  745.   logon capability.  Please feel free to add or delete as you choose.
  746.   The file can contain up to 30 server definitions.
  747.  
  748.   Support for non-standard FTP port numbers has been added in version 0.82.
  749.   
  750. Function Keys
  751.   The FKEYS.TXT file is in the program-path (i.e. same directory as
  752.   NEWSIE.PRG).  This file is loaded at startup and is activated when the
  753.   user presses a function key F1 thru F10, or F11 thru F20 (shift F1 thru
  754.   F10).  The text of the key is compared with the menu items, and if they
  755.   match, the menu item is executed.  Example:
  756.  
  757.     F1<tab>Quit
  758.     F2<tab>Edit Nicknames
  759.     ...
  760.     
  761.   Between the F1 and Quit is a single <tab> character.  Function
  762.   keys are F1 thru F20 inclusive.  A sample file is included in the
  763.   distribution (zip) file.  Function key definitions are editable via
  764.   the Edit Function Keys menu entry in the Preferences menu.
  765.   
  766.   Note: for non-english users, use the menu text as it appears in the menu 
  767.   items.  i.e. Sauver for Save, Sauver comme for Save As, etc.
  768.  
  769. Address Book
  770.   The Address book is currently limited to a single file: ADDRESS.ABK, and 
  771.   resides in the work path with NEWSIE.PRG.  Future versions may provide 
  772.   the ability to have multiple Address Books.
  773.  
  774. Mail List Attribution Support
  775.   It is possible to subscribe to Mail lists.  These mail list servers provide
  776.   a copy of email sent to them to every subscribed member.  It is often very
  777.   useful to have an indication on replies to indicate what member initiated the
  778.   message, in the form 'On <some date>, <the user> wrote:'.  This is handled by
  779.   NEWSie with a file called LISTSVR.TXT located in the Mail Path.  An example
  780.   is included in the MAIL directory in the distribution ZIP file.
  781.  
  782.   There is no dialog to modifiy this file.  You must edit it manually if you
  783.   would like to use this feature.  NEWSie checks this file, and tries to match
  784.   the destination email address with one of the entries in the file.  If there
  785.   is a match, the Attribution line (On <date>, <user>...) is produced.  This 
  786.   processing only affects reply messages.
  787.  
  788. HELP Files
  789.   There are text files in the HELP directory which may be viewed at any 
  790.   time by pressing the Help key.  Help is based upon the current top 
  791.   window.  If there are no windows, or the Help window is currently on 
  792.   top, the General Help file is displayed.  See the non-english 
  793.   language HELP in the LANGUAGES directory.  With version 0.80, NEWSie 
  794.   supports ST-Guide hypertext (.HYP) help files too!
  795.   
  796.   In version 0.68 and above, the right mouse button also initiates the 
  797.   help processing.  If your computer has AES version 3.3 or above, there 
  798.   are additional commands in the popup menu displayed.
  799.   
  800.  
  801. 5. STARTUP OPTIONS
  802.   NEWSie startup features include the following:
  803.     CAB Internet Client Support
  804.     Select NewsGroup file at startup
  805.     Select Preference file at startup
  806.  
  807. CAB Internet Client Support
  808.   With the introduction of CAB 1.5, comes the ability for CAB to
  809.   start other programs based upon the URL (Uniform Resource Locator).
  810.   NEWSie had a start at handling the 'news:' URLs, but was never tested.
  811.  
  812.   The following URLS are supported by NEWSie:
  813.     'news:' - a newsgroup name is the only parameter supported.
  814.       The <message-id> option is not supported by NEWSie at this time.
  815.  
  816.   Note: a message-id contains the '@' character, and newsgroup names do not.
  817.  
  818.     'ftp://' - the following formats are supported:
  819.         ftp://domain/directory
  820.         ftp://userid:password@domain:port/directory
  821.       the first is called 'anonymous' and the second is 'non-anonymous'.
  822.       This second method requires a userid and password for the domain.
  823.       It is useful for local use, but should never occur on Web pages,
  824.       since the password could be seen by anybody.
  825.  
  826.     'mailto:' - followed by a email-address.  This is already supported
  827.       within CAB, but NEWSie is used, the OUTBOX copy feature is available,
  828.       etc.
  829.  
  830.   These have been tested on TOS 4.04 and Magic, but not MultiTOS, Geneva,  
  831.   etc.  NEWSie does recognize VA_START commands from external clients.
  832.  
  833. Select NewsGroup file at startup
  834.   NEWSie has the ability to be started with a particular newsgroup file
  835.   If defined as a Desktop Application for file type '.GRP', NEWSie will use
  836.   the specified GRP file instead of the DEEFAULT.GRP file.
  837.  
  838. Select Preferences file at startup
  839.   NEWSie will provide the ability to startup with a Preferences file other
  840.   than PREFS.INF when either of the Shift Keys are held down when starting
  841.   the program.  This will produce the Load Preferences File Selector.
  842.  
  843.   Note: The PREFS.INF is loaded first, then the newly selected prefs file.
  844.  
  845.  
  846. 6. SETUP and USAGE
  847.  
  848. Several things are necessary to use NEWSie from the distribution ZIP file.
  849.  
  850. 1. Unzip the NEWSIEnn.ZIP file and move to where ever you want it.
  851. 2. Enable STiK if it is installed.  If you don't have STiK installed, you 
  852.    will not be able to perform any Online activities with NEWSie.
  853. 3. Double-click on NEWSIE.PRG
  854. 4. Immediately go to the Preferences Menu and fill in the following:
  855.      Personal Preferences
  856.      Server Preferences (especially the NewsServer name)
  857.      Path Preferences for editor and viewer usage, MAIL and OFFLINE path
  858.      Other Preferences as you choose
  859.      Save Preferences
  860. 5. Quit NEWSie via Quit in File menu
  861. 6. If not already connected to the Internet (via STiK dialer), do so.
  862. 7. Execute NEWSie again, hopefully getting a connection to your NewsServer.  
  863.    If you have selected 'Connect at Startup' in the Server Preferences, 
  864.    this should occur automatically, otherwise, use the 'Manual Connect' 
  865.    item in the Special Menu.
  866. 8. If you speak French, Italian or Swedish, you may want to use the NEWSIEFR.RSC, 
  867.    NEWSIEIT.RSC, or NEWSIESV.RSC and the French, Italian, or Swedish HELP files. 
  868.    Program documentation is also available in these languages.  See the 
  869.    LANGUAGE directory for more information.
  870. 9. Report problems to:  rojewski@primenet.com.
  871.  
  872. NOTE:  If you upgrade to a new release of NEWSie, make certain you keep 
  873. the PRG and RSC files co-ordinated.  Failure to apply the correct RSC file 
  874. can cause major problems...
  875.  
  876.  
  877. 7. FUTURE ENHANCEMENTS
  878.  
  879. Enhancements to NEWSie are planned.  The current package is continuously
  880. being improved.  (Unfortunately there are only so many hours of programming
  881. time in a week...)
  882.  
  883. Some acknowledged areas of weakness are:
  884.      Documentation of features (i.e this document)
  885.      News Article management
  886.  
  887. See IMPROVE.DOC for a survey of suggested improvements.
  888.      
  889.      
  890. 8. KNOWN PROBLEMS (0.80)
  891.      Atari Works cannot be used as external editor/viewer
  892.      FTP servers that will not allow the PASV command are not available 
  893.          via NEWSie.
  894.      Some problems with 'Edit Nicknames'.  Causes 2 bombs for some. 
  895.  
  896. See HISTORY.DOC to see what has changed in the previous version(s).
  897.  
  898. See WHATS.NEW to see what is new in this version. 
  899.  
  900.  
  901.  
  902.  
  903.     
  904.  
  905.  
  906.     
  907.  
  908.